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(57) Abstract 

A method and apparatus for generating customizable documents comprising a datafile including a data structure for defining 
relationships between elements of a document and variations thereof; a parser for reading the datafile and for creating instances of 
document-class data structures in accordance with general document class definitions; a user input interface for inputting purpose parameters 
specifying a document variation; a selection engine for utilizing the cuirent values of the purpose parameters for generating customized 
versions of said document. 
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A Method and Apparatus for Authoring 
of Customizable Multimedia Documents 
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This invention relates to a method and apparatus for the authoring of 
5 customizable mukimedia documents and the adaptive generation of versions thereof 
for particular uses. 



Background of the Invention 

Natural Language Generation (NLG) is a young but growing research field, 
10 whose goal is to build computer systems that automatically produce fluent and 
effective texts in various human languages. Generally, NLG systems have used 
knowledge databases containing general world knowledge and specific domain 
knowledge, together with various linguistic resources (e.g., lexicons, grammars, 
discourse relations), to produce texts with limited variation in word choice, sentence 
15 and discourse structure, and virtually no variation in rhetorical style or pragmatic 
purpose. 

While various computational systems have been devised as solutions to the 
problem of producing documents with limited expressiveness in form and effect, none 
has presented a general solution to the problem of representing the kinds of 

20 knowledge that are needed to produce documents tailored to a specific use or 

audience in a manner that is systematic and extensible, and that further provides for 
the authoring of such documents by a non-computer-programmer professional writer. 
In addition, no system has yet presented a general solution for automatically 
integrating various aspects of document design (e.g., text, graphics, and presentation 

25 layout) into a single consistent representation format for use within a document 
intended for customization. 

It is well-known from studies in communication that presentation of 
information in a manner that is tailored to the characteristics of a particular audience 
can be significant both in maintaining the interest of the members of the audience and 

30 in effectively conveying the meaning of the information. For example, in the health 
care industry, it has been shown that information that is tailored to the characteristics 
of an individual patient can have a far greater effect in producing compliance with 
suggested medical regimens as compared to generic information. (Strecher et al 1 994 
have done pioneering work in this area). 
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But as Strecher et al's behavioural studies also showed, a sizeable number of 
different medical and personality factors had to be taken into account in producing 
customized health information that would have the desired effect on the intended 
patient. DiMarco et al (1995) noted that this kind of customization involves much 
5 more than producing each brochure or leaflet in half a dozen different versions for 
different audiences. Rather, the number of different combinations could easily be in 
the tens of thousands. While not all distinct combinations might need distinct 
customizations, it is nonetheless impossible in general to produce and distribute, in 
advance of need, the large number of different editions of each publication that is 
1 0 required for individual tailoring of information. 

Thus there is a need for a computer system for the automated production of 
customized material that would tailor a general-pu^jose "master document" for a 
particular purpose or individual on demand. It must also be remembered that in the 
present context the term "document" is broadly used to define any textual or non- 
5 textual data, including multimedia and hypertext, having inter-relationships between 
the data, and that may be displayable or presented to a human audience in one of 
many presentations and formats. 

As a further example, a master document may refer to the complete superset of 
mstructions to direct the actions of a robot on an assembly line. In this instance, there 
> exists a need to tailor or adaptively generate subsets of combinations of instructions 
for specific robot applications. Whether the master document is to be customized for 
a particular puipose. as in the robot example, or tailored for a specific audience as in 
the case of health information, this process of adaptive document generation should 
be easily implementable on a computer system at minimum possible cost and 
maximum possible ease of use to both the author of the master documem and the user 
of the generation system. 

In the field of natural language processing, or, computational linguistics, 
various computer systems have been implemented which attempt to produce 
customized documents. In the simplest cases, simple mail-merge techniques are used 
which enable "personalized" documents to be generated by using hand-coded decision 
rules indicating what information is to be included for various tailoring situations 
However, these techniques result in very inflexible, and often, awkwardly structured 
and poorly cohesive texts. Other systems utilize schema-based techniques to select ' 
and organize the content data according to simple document-template structures But 
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these templates are either too general-purpose to provide anything more than very 
coarse-grained adaptation in the resulting customized texts or too specific to the 
application in question to be appropriate for general use in adaptive generation 
systems. 

5 A number of projects have used more sophisticated techniques from NLG 

research to build adaptive generation systems for both written texts and hypertext 
documents. The IDAS project (Reiter, Mellish, and Levine 1995) recognized the 
need to tailor both textual and non-textual information, including visual formatting, 
hypertext input, and graphics output. IDAS also tried to address the need for explicit 

10 authoring tools in the adaptive document generation process, but here the focus was 
on authoring at the knowledge-base level (i.e., at the level of a computer system's 
internal representation), while there still exists a need to provide an authoring tool that 
may be used by a non-computer-programmer professional writer who could compose 
the master document at the level of ordinary English, with additional markup as 

15 required (e.g., HTML markup to support an HTML presentation format for a resulting 
customized version of the document). IDAS relies mainly on canned texts and aims 
to provide the user with a means of navigating through the whole "hyperspace" of 
possible (canned) texts. There is however a need to provide for a much finer-grained 
degree of tailoring than the IDAS implementation. 

20 While IDAS relies mainly on canned texts, other adaptive generation systems 

do use more-dynamic text generation: the Migraine system (Carenini, Mittal, and 
Moore 1994) uses an approach to text planning that adaptively selects and structures 
the information to be given to a particular reader. However, Migraine relies on a 
large number of context-sensitive and user-sensitive "text plans" (i.e., text schemas) 

25 so that its methods of tailoring must of necessity be very specific to its particular 

domain. The PEBA-II system (Milosavljevic and Dale 1996) uses more-general text 
plans, as well as text templates, that it can choose from to adapt information to the 
individual reader, but the tailoring done is very specific, focussing on the user's 
familiarity with a topic. The PIGLET system (Cawsey, Binsted, and Jones 1995) also 

30 uses a combination of text plans and text templates, but its tailoring is also quite 
specific in nature, mainly concerned with emphasizing material that is relevant to a 
particular patient. The ILEX-0 system (Knott, Mellish, Oberlander, and O'Donnell 
1996) is similar to the PIGLET model in its anticipation of all the possible texts that 
might be generated, but also includes annotations (e.g., a condition on a piece of 
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canned text) to allow some local customization. However, very free and flexible use 
of annotations could lead to problems of repetitive text and inappropriate use of 
referring expressions in the resulting document, requiring textual repair. 

None of the previous systems provide for a text-repair facility of the kind 
5 <iescribedbyHovyandWanner(1996)andWannerandHovy(1996). Theparadigm 
of adaptive document generation by "selection and repair", as introduced by DiMarco 
Hirst, Wilkinson, and Wanner (1995), that is, selection of the relevant pieces of 
.nfonnation from a master document, and then repair of any syntactic or stylistic 
problems in the resulting document by a text-repair facility, is central to the goals of a 
0 customizable document system. However, the system should be able to support either 
an adaptive generation system with full facilities for selecting and repairing texts as 
described by DiMarco, Hirst, Wilkinson, and Wanner (1995) and Hirst, DiMarco 
Hovy, and Parsons (1997), or a simpler version of the system, based on "generation 
by selection only", i.e., with no facilities for textual repair, an implementation of 
5 which (called "WebbeDoc") is described by DiMarco and Foster (1997). 

In summary, an author of a customizable document needs to be able to 
describe the variations of a document, which may be both textual and non-textual at 
vanous levels of the document structure, together with the conditions for selecting 
each variation. 



The author then needs a means of selecting all the appropriate variations for a 
particular puipose or audience, re-assembling the selected variations into a coherent 
document, and producing an appropriately customized version of the document in 
potentially many different levels of representation (e.g., surface English, a deep 
syntactic or semantic representation for use in textual repair) and presentation fonnats 
25 (e.g., HTML, LaTeX). 

None of the existing adaptive document generation systems has provided a 
generally applicable method and apparatus for describing all the different ways in 
which a document could be customized, or for providing for a non-computer- 
programmer author of a customizable document to specify the possible variations or 
30 for selecting the appropriate variations and producing a customized version of a ' 
document 



4 



wo 99/08205 



PCT/CA98/00771 



Summary of the Invention 

It is therefore an object of this invention to provide a system which mitigates 
to some extent the above outlined disadvantages. Also, the methods used by the 
present invention are more general than those used in previous systems, allowing not 

5 only the potential inclusion of text plans and schemas, text templates, and canned text, 
but also the dynamic generation of text that can then be subjected to very fine-grained 
revision and tailoring by a text-repair facility. 

This invention seeks to provide a computer system for customizing an initial 
master document containing information for a multiplicity of versions of the 

10 document intended for the different purposes or different users, for a specific purpose 
or for a specific user. 

In accordance with this invention, there is provided a computer system for 
customizing an initial master document in accordance with a user-defined set of 
purpose parameters. In accordance with a fiirther aspect of the invention there is 

1 5 provided a data structure (i.e., the customizable, "master", document) for specifying 
relationships between elements of the document and between elements of the 
document and their variations. 

A master document will therefore contain all the information that the system 
might need to include in any particular customized version of the document, together 

20 with annotations giving the selection conditions as to when each piece of information 
is relevant and other annotations giving linguistic and formatting information, 
including for multimedia elements of the document. 

A further aspect of the invention provides for a method and apparatus for 
reading said data structure into a form implementable on a suitably progranuned 

25 processor such that the implementation of the data structure can store both the form 
and content of a master document, i.e., all the elements of the document and their 
variations, and can also act as the process for selecting the relevant variations of the 
document, according to given values of input parameters specifying the intended 
purpose or intended user, and then generating the appropriately customized version of 

30 the document. 



Brief Description of the Drawings 
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A better understanding of the invention will be obtained by reference to the 
detailed description of a preferred embodin^ent below and in regard to the following 

drawings in which; 

Figure 1 is a schematic diagram showing the architecture of the system- 
5 Figure 2 shows a generalised form of a data structure for specifying a customizable 
master, document according to an embodiment of the present invention- 
F,gure 3(a) shows a generalised form of a data substructure for use within the main 
data structure for specifying linguistic or presentation fonnat information for a 
component of the master document; 
■0 Figure 3(b) shows a generalised form of a data substructure for use within the main 
data structure for specifying hypertext links to parts of the main data stn^cture or to 
other data structures of the form as specified in Figure 2 and provided in other source 
datafiles; 

Figure 4 . a flowchart of the overall process of reading-in as input the data stn^cture 
15 and generating as output a final customized version of the document- and 

Figure 5 is a graph showing the resolution process for a customized document 
generated according to an embodiment of the present invention; 

Detailed Description of A Preferred Embodiment 

20 architecture Of a customizable document system the 

tadonng engine", is shown generally by numeral 10. The system comprises- a ' 
datafile 12 including a data structure 13 for defining a master documem; a parser 14 
for readmg in the contents of the datafile 12 and for creating instances of the 
document-class data structures 1 8 in accordance with the general definitions of 

25 d«-classdatastructuresl6;auserinputinterface20forreadingnewvaluesof 
purpose parameters 22 which are input by a selection engine 1 8. The selection engine 
18 uses the cu.ent values of the puipose parameters to select the .levant variations 
of each component of the document and to generate appropriately customized 

---26ofadocument,whichmayalsoincludehypertextlinlcstonewdocuments 
^0 28, wh.ch may themselves be customizable documents of the form illustrated in 

Figure 2. 



The term "purpose parameter" as used herein means a parameter used in 
evaluatmg a selection condition associated with a particular variation of a documem 
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Structure, where this parameter can be used in defining either a particular intended 
purpose or use of a customized version of the document or a particular intended user 
or audience for a customized version. These elements are explained in detail below. 
Furthermore, the datafile may be generated by an authoring tool 30 in 
5 accordance with the detailed explanation below. 

Referring to figure 2 an embodiment of the data structure 13 according to the 
present invention is described, which shows the blocks, sub-blocks, fields, and 
subfields of the data structure. 

The data structure 13 has the following main blocks of information: 
10 1 . Identification of purpose parameters and representation-level parameters, 

and their possible values. 

2. Identification of toplevel object (i.e., the main Document). 

3 . Definitions of main Document and any subDocuments. 

4. Definitions of Sections. 
15 5 . Definitions of Topics. 

6. Definitions of Sentences. 

7. Definitions of Lexicals. 

8. Definitions of Words. 

9. Definitions of Armotations (replaces, previous 9. Definitions of Formats). 
20 10. Definitions of External objects. 

Each of these blocks of the data structure will now be described in turn. 



Block 1: The purpose parameters. The first block of the data structure identifies 
25 the purpose parameters, or user parameters, together with their possible values, that 

can be used in forming the Boolean expressions that give the conditions for selecting 

each variation of a document. 

The first block also identifies the representation-level parameters, together 

with their possible values, that can be used in forming the Boolean expressions that 
30 give the conditions for selecting each desired level of representation of the sentences 

in the master document during the process of generating a customized version of the 

document. 
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BloA 2= The .optevel .bjeC. The .oplevd objec. id=„,if,es dccumem-clas. 

■ns^ce whichUthe ■■roo," element of*een.ired«,.,wi,h,hi.„bjec,a„, 
the re^olufon pr^^ fa genen„i„g a e»,„„^zed version of fte documen, begins. 

5 Block, 3-9: The progran, „n.c«.res. Block. 3-9 describe fte progran, suucn.es 
*e classes to, i„p,e„,e„, d,e snbsimcm^s of ,he data suncn,. d,a. specify ,hc fo™ 
and contea of a cns,on„zable document The progmn, snucnres a,e related in 

following manner: 

A darafde de^bing a sc, of pmgram sttucnnes is a particular example of a 
customizable doctmtent created for various uses. The dataflle may be divided into 

various parts. 

Firstly, the data structure may be divided into components, or elements 
refen-ed to as the classes Document, Section, Topic, Sentence, and Lexical, which 
each implement a substmcture of the data structure that defines a component of a 
customizable document. Each such substructure of the data structure also includes the 
vanat.ons of a component and the conditions for selecting the appropriate variation of 
a component. 

In addition, the data strucmre contains basic components „hich ate instances 
o the classes Word and A^totation. »d other components, which are instances of «^ 
Class bxtemal, for linking to other datafiles. 

Block 3: The Documents. 

In Figure 2,Block3describes the instances ofthe class Document. Each Document 
description must specify the following properties: 

- A list of its variations. Each variation must be an instance of the class 
DocumentVariation. 

- A hst of its annotations. Each am^otation must be an instance of the class 
Annotation. 

An instance of the class Annotation can specify both textual and non-textual 
properties of a document or a componem of a document in terms of a 
particular document-layout format, structure, or linguistic representation For 
example, an Amiotation object could specify multimedia elements of the 
document's layout, such as ahgnment of text, font size, background colour 
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text colour, and graphics; other Annotation objects could specify linguistic 
information such as discourse relations or coreference links. 
Each variation of a Document class is then described as an instance of the class 
DocumentVariation. Each DocumentVariation description specifies the following 
5 properties: 

- The condition for selecting this variation. The condition must be a 
Boolean expression composed from pairs of purpose parameters and their 
allowable values. 

- A list of the components of this variation. Each component must either be 
10 an instance of the class Document or an instance of the class Section. 

- A list of annotations for this variation. Each annotation must be an 
instance of the class Annotation. 

Block 4: The Sections. Block 4 describes the instances of the class Section. Each 
15 Section description specifies the follovmig properties: 

- A list of its variations. Each variation must be an instance of the class 
SectionVariation. 

- A list of its annotations. Each annotation must be an instance of the class 
Annotation. 

20 Each variation of a Section class is then described as an instance of the class 
SectionVariation. Each SectionVariation description specifies the following 
properties: 

- The condition for selecting this variation. The condition must be a 
Boolean expression composed from pairs of purpose parameters and their 

25 allowable values. 

- A list of the components of this variation. Each component must either be 
an instance of the class Section or an instance of the class Topic. 

- A list of the annotations for this variation. Each annotation must be an 
instance of the class Annotation. 

30 

Block 5: The Topics. Block 5 describes the instances of the class Topic. Each 
Topic description specifies the following properties: 

- A list of its variations. Each variation must be an instance of the class 
Topic-Variation, 
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- A list of its annotations. Each annotation must be an instance of the class 
Annotation. 

Each variation of a Topic class is then described as an instance of the class 
TopicVariation. Each TopicVariation description specifies the following properties- 
5 - The condition for selecting this variation. The condition must be a 

Boolean expression composed from pairs of purpose parameters and their 
allowable values. 

- A list of the components of this variation. Each component must either be 
an mstance of the class Topic or an instance of the class Sentence 

- A list of the annotations for this variation. Each amiotation must be an 
mstance of the class Annotation. 

Block 6: The Sentences. Block 6 describes the instances of the class Sentence 
Each Sentence description must specify the following properties: 

- A list of its variations. Each variation must be an instance of the class 

SentenceVariation. 

- A list of its annotations. Each annotation must be an instance of the class 

Annotation, 

Each variation of. Sendee class is fa described as an instance of class 
Sen.ence-Varia.ion. Each SeMenceVariaUon description mus. specify ,he foUov™,, 

properties: ^ 

- The condition for selecting this variation. The condition must be a 
Boolean expression composed from pair, of purpose parameters and their 
allowable values. 

- A list of the components of this variation. 

- A list of the representations of this variation. Each representation must be 
an mstance of the class SentenceRepLevel. 

- A list of amiotations for this variation. Each annotation must be an 
instance of the class Annotation. 

30 Each SentenceRepLevel description must specify the following properties- 

- The condition for selecting this sentence representation. TT,e condition 
must be a list of one or more representation-level parameters. 

- A list of the components of this variation. Each component must be an 
instance of the class Lexical. 
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- A list of the annotations for this variation. Each annotation must be an 
instance of the class Annotation. 

In the current implementation of the system, an instance of the class 
5 SentenceRepLevel may be a character string, with any Lexical components identified 
by surrounding reserved characters. This is a simplification made for ease of testing 
system prototypes, and does not limit the scope of the invention. 



10 Block?: TheLexicais. Block 7 describes the instances of the class Lexical. Each 
Lexical description must specify the following property: 

- A list of its variations. Each variation must be an instance of the class 
LexicalVariation. 

- A list of its annotations. Each annotation must be an instance of the class 
15 Annotation. 

Each variation of a Lexical class is then described as an mstance of the class 
LexicalVariation. Each LexicalVariation description must specify the following 
properties: 

- The condition for selecting this variation. The condition must be a 

20 Boolean expression composed from pairs of purpose parameters and their 

allowable values. 

- A character string associated with this LexicalVariation instance. 

- A list of annotations for this variation. Each annotation must be an 
instance of the class Annotation. 

25 - A single component, which may be an instance of any of the classes 

External, Word, Lexical, Sentence, Topic, Section, or Document. Each of 

these cases is dealt with as follows: 
L If a component is a Word, then it is treated as a simple string to be 

concatenated to the result returned. 
30 2. If a component is a Lexical, then it is treated as a set of variations of a 

word, which will be resolved to select the appropriate version of the word. 

In this way, near-synonymy can be handled within the system. 
3. If a component is a Sentence, Topic, or Section, then it is treated as a set 

of 
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variations of a separate piece of a document, which will be resolved to 
select the appropriate version. 

In this way, adaptive hypertext can be handled within the system. 

4. If a component is a Document, then it is treated as a whole complete 
document. 

In this way, hypertext links to other documents internal to the same 
datafile can be handled within the system. 

5. If a component is an External object, then it is treated as a whole complete 

customizable document. 

In this way, hypertext links to other customizable documents can be 
handled within the system. 



Blocks: The Words. Block 8 describes the instances of the class Word. Each 
Word description must specify its associated string and its associated annotations. 
Each annotation must be an instance of the class Annotation. 

Block 9: The Annotations. Block 9 describes the instances of the class Annotation 
that W.11 be used to insert all the relevant linguistic and fonnatting information into 
the customized version of the document to be output. A description of block 9 is not 
mcluded in figure 2. Instead, the general structure of an Annotation class object is 
shown in figure 3(a). 

The Annotation objects can be grouped into several distinct sub-taxonomies 
one for each type of linguistic or formatting annotations that will be attached to the ' 
mam master-documem data structure. For example, one Annotation sub-taxonomy 
nught specify details of HTML layout for the overall document and each component 
of the document; another Amiotation sub-taxonomy might record properties of the 
discourse structure of the overall document and each component of the document 
such as rhetorical relations and coreference links. Each Annotation object has a ' 
property "parent" to reference its immediate ancestor in its (sub-)taxonomy. 

Block 10: The Externals. Block 10 describes the instances of the class External 
which will be used to create hypertext links to other customizable documents 
specified in other datafiles. 

Each External description must specify the following attributes: 



12 



wo 99/08205 PCT/CA98/00771 

- The name of the file containing the external customizable document. 

- A user profile. The user profile is a list of parameters that describe the 
user or audience for whom the document customization is being 
performed. 

5 The general structure of an External class object is shown in figure 3(b). 

The data structure 13 according to the present invention allows an author to 
describe the structure of a customizable document (i.e., a master document). The data 
structure has a recursive and object-oriented form and can be implemented using an 
object-oriented programming language so that a customizable document described in 
10 the form of the data structure can be implemented as an object-oriented computer 
program. 

The elements of the data structure are related by both part relationships and by 
inheritance relationships, so that the relationships between the elements of a 
customizable document described in the form of the data structure and implemented 

15 as a corresponding object-oriented computer progreim can be recognized and 

maintained by the object hierarchy and inheritance mechanism of an object-oriented 
computer program. 

Moreover, an object-oriented computer program that implements the data 
structure is both the form and content of a customizable document and the process for 

20 selecting and generating an appropriately customized version of the document. Thus 
the data structure is generic in the sense that it can implement any customizable 
document given in the form of the data structure. 

The data structure 13 describes the corpus text of a specific customizable 
document (i.e., a master document) having elements and structure, as shovm in figures 

25 2(a) , 2(b) and 2(c) following. 

The form of the data structure is defined by the set of general class objects 16 
describing the elements and structure of a customizable document in terms of object- 
oriented program structures. These class objects are related by both part relationships 
and by inheritance relationships to be explained below. 

30 The operation of the system 1 0 (the "tailoring engine") may be explained as 

follows: 

The parser program 14 reads in and parses the master-document datafile 12 to 
recognize its structure and then maps the contents of the input datafile into class 
objects of name according to class names specified in the input data structure. 
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Properties of the classes are also recognized according to information contained in the 

data structure. 

The parser program 14 also acts as a document-class instantiator program 
wh.ch uses the parsed contents of the input datafile to dynamically create instances of 
5 the program structures identified by the general class objects described above 
Properties of the classes are also dynamically assigned according to infonnation 
contained m the data structure. 

An integration of data structures with the main process of the system 

comprises the following: 

0 The instances of the class objects dynamically generated from the input 

datafile, which provide two simultaneous functions: 

1. The program data structures describing the elements, structure, and content 

of the master document. 

2. The selection process for generating the appropriate customized version of 
the document. 

Thus, a feature of the system is that given the current values of the purpose 
par^eters, the instances of the prog,^ data structures, that is to say, the instances of 
the class objects describing the elements of the master document, execute themselves 
to select and generate the appropriate customized version of the document 

The core of the system, that is, the integration of program data structures with 
the selection process, is generic in tenns of the following properties: 

Application-independent. The system core is independent of the application- 

the onlyitems that need be re-definedforanewapplicationare the input datafile and" 
the mterface for reading the current values of the purpose parameters. This is 
discussed further below. 

Platform-independent. The system core is currently implemented in the Java 
programming language, so is platform-independent to the same extent as Java itself 

Processor-independent The system core is currently implemented in the 
Java programming language, but is independent of the underlying progi^ming 
language, i.e., processor, to the extent that the programming language used must 
prov.de an object-oriented paradigm and a semantics for property inheritance that is 
consistent with the specification of the resolution process used in the system for 
generatmg a customized version of a document from the instances of the program data 
Structures. 
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The process of generating a customized version of a document from the 
instances of the program structures is referred to as resolution and will be discussed 
later with reference to Figure 5. 

A customized version of a document can be generated in any number of 
5 different levels of representation of its content (e.g., surface English; a syntactic or 
semantic representation to be used by a text-repair facility; and so on). The different 
representations to be generated for any given application must be indicated by the 
representation-level parameters in the description of the document given by the data 
structure in the input datafile. This information is specified in block 1 of the data 

10 structure as described with reference to figures 2(a), 2(b), and 2(c) above. 

Each different representation of the content of a customized version of the 
document will be generated along with a list of all the relevant annotations to the 
content. These annotations provide information on the multiple forms in which the 
document may subsequently be presented to a reader, and the linguistic information 

15 that may be used to guide subsequent repair of the customized document. The 

customized document that is generated will also include all annotations to the content 
concerning the External objects that can be used to provide hypertext links to other 
customizable documents or to other applications of the system 10 (the "tailoring 
engine") from figure 1. 

20 The process of generating a customized version of a master document is 

shown in Figure 4. There are two main stages to this process, the initial setup and the 
main program loop. In the initial setup, the input datafile is read in and parsed, and 
the appropriate instances of the various document classes described above are created. 
The parser program 14 reads in the input datafile 12, which contains the data structure 

25 1 3 giving the specification of a customizable document. As it reads in the file, the 
driver program also acts as a class instantiator to create instances of all relevant 
document classes according to the input data structure. Program links, i.e., references, 
are created between these class instances via the setting of their properties and 
assignment of their property values. 

30 In each iteration of the main program loop, new values of the purpose 

parameters are read in, and a customized version of the document is generated as 
output for each specified level of representation. A user interface in the form of a 
reader program 20 obtains the new values of the purpose parameters. In the latter 
instance, the parameter values may be entered interactively or may be read in from 
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previously corr^piled profiles of user preferences stored in computer databases This 
allows for the mass customization of information for high volumes of individual users 
with diverse characteristics, such as in the mass production of personalised financial 

investment advice. 

A selection engine 18 resolves the document instances created in the setup 
stage according to the current values of the purpose parameters to generate the 
appropriately customized version of the document. TTie customized document is 
output in all specified levels of representation with all relevant linguistic and 
formatting information attached to each component of the document If there are no 

0 more new purpose-parameter values to read in, the main program loop terminates 

The process of selecting the appropriate variation of each document structure 
IS called "resolution". Figure 5 is a graph showing the resolution process for a 
customized document generated according to an embodiment of the present invention 
The pseudocode for the Resolve procedures, which implement the resolution process ' 

> IS as follows: * 

Procedure: Resolve (for VariationContainer classes) 

Parameters 

- (input) 

An instance of WorkingCondition 

(a list of purpose parameters and their current values) 

- (input) 

An instance of List 

(a list of the desired representation levels to output) 

- (output) 

An instance of DocumentObjectSet, 

i.e., a set of references to resolved DocumentObjects, 

with one set member for each desired level of representation 

of this VariationContainer instance 

Algorithm: 

if Resolve has already been called with this WorkingCondition then 

result is the previously saved result 
else 

call Satisfies on each variation of this Variation Container until 



16 



wo 99/08205 PCT/C A98/0077 1 

the WorkingCondition is satisfied 
call Resolve on this satisfying variation to 

return a DocumentObjectSet 
add the appropriate annotations for this VariationContainer into 
5 the returned DocumentObjectSet 

end if 

if no variation satisfies the WorkingCondition then 

result is null 
else 

10 result is the annotated DocumentObjectSet for this VariationContainer 

end if 

Procedure: Resolve (for Variation classes) 
Parameters: 
15 - (input) 

An instance of WorkingCondition 
- (input) 
An instance of List 

(a list of the desired representation levels to output) 
20 - (output) 

An instance of DocumentObjectSet, 
i.e., a set of references to resolved DocumentObjects, 
with one set member for each desired level of representation 
of this Variation instance 

25 

Algorithm: 

create a new DocumentObjectSet for this Variation 
for each component of this Variation do 
call Resolve on the current component to 
30 return a DocumentObjectSet for this component 

add the appropriate annotations for this Variation into 

the returned DocumentObjectSet 
attach the annotated DocumentObjectSet 

as a child of the DocumentObjectSet for this Variation 
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end for 

result is the annotated DocumentObjectSet for this Variation 

The "resolution" of the appropriate annotations for a given input data stnactur^ is 

5 handled as follows: 

Each instance of a document class in the input data structure, down to the level 
of a Word instance, has an "annotations" property, which may be null, associated with 
It. Th,s property is a list of all the Annotation objects that apply to this document-class 
instance and must contain one Am^otation object for each of the distinct sub- 
»0 taxonomies in the overall class of Annotation objects. 

When a document-class instance is bemg resolved, its set of Annotation 
objects, as specified in its "annotations" property, will be collected and included in 
the content of the customized document. 

In summary, an application system which wishes to put the invention into 
1 5 practice must execute the following steps: 

1 . An input datafile of the structure as described with reference to figures 
2(a), 2(b), and 2(c) is created; 

2. A user interface in the form of a trader program to obtain new values of 
purpose parameters is provided. This reader program returns as output an 
mstance of WorkingCondition which is a set of purpose parameters and 
their values (implemented as a hashtable in one embodimem of the 
invention). 

3. The main program first reads in the datafile, then calls the reader program 
to obtain a new instance of WorkingCondition. The main program will 
then start the resolution process for the toplevel Document object by 
passing it the WorkingCondition. 

4. The output of each iteration of the main program will be a customized 
version of the document in all the levels of representation specified in the 
input datafile using the representation-level parameters. Each 

30 representation of the customized document is output for possible later 

processing by the application system. 



20 
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Sample Data Structures 

Selections from two sample data structures are presented in this section. The 
first example is for the customizable home page of the HealthDoc Project at the 
5 University of Waterloo (Waterloo, Canada). The second example is for a master 
document giving basic health information on diabetes. 

Note that in the LexicalVariation labelled "lexDiabetesMaster-a" in Example 1, there 
is 

10 a link to another completely separate customizable document, contained in a different 
input datafile. This link is made through an instance of the External class. 



Example 1: A Customizable Web Page 

15 

// The parameters 
PurposeParameters 
|role=CLexpert physician layperson funder& 
technical =high low& 
20 age=senior adult child& 

formality=formal informal& 
coolness=cool bland| 

RepresentationLevelParameters 
25 |levels=english| 

// The top-level object 
toplevel=Document.v^ebbedoc 

30 // The Docvunents and Document Variations 
Document webbedoc 
|title="The HealthDoc Project Home Page"& 
variations=doc-a doc-b doc-c doc-d doc-e doc-f doc-g doc-h& 
annotations=html-doc-webbedoc-toplevel| 

35 

DocumentVariation doc-a 
|condition=(and (coolness cool) (age adult) (role CLexpert))& 
componentList=Section.secl Section.sec2 Section.sec3 Section.sec4 
Section.secS Section.sec6 Section.sec7& 
40 annotations=html-doc-webbedoc-doc-a| 

DocumentVariation doc-d 
|condition=(and (coolness bland) (age adult))& 
componentList=Section.secl Section.sec2 Section.sec3 Section.sec4 
45 Section.secS Section.sec6 Section.sec7& 

annotations=html-doc-webbedoc-doc-d| 

// The Sections and SectionVariations 
Section seel 

50 |variations=secla seclb seclc secld secle seclf 
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seclg seclh secli seclj seclk secU 
seclm secln seclo seclp seclq seclr& 
annotations=htinI-sec-webbedoc-sec 1 1 

5 Section Variation sec 1 a 
|condition= 

(and (role ftinder)(technical alI)(coolness bland)(fonnality formal))& 
componentList==Section.subsecM Section. subsecl.2& 
annotations-htra]-sec-webbedoc-secla| 

Section subsecl-l 
|variations=subsec 1 -1 a& 
annotations-html-sec-webbedoc-subsec 1 - 1 1 

1 5 Section Variation subsec I - 1 a 
|condition=()& 

componentList=Topic.topic 1 & 
annotations=html-sec-webbedoc-subsecI -1 1 

20 Section sec2 

|variations=sec2a sec2b& 
annotations=htm]-sec-webbedoc-sec2| 

Section subsec2-l 
25 |variations=subsec2- 1 a& 

annotations=html-sec-webbedoc-subsec2- 1 1 



30 



Section Variation subsec2-la 
|condition=()& 

componentList=Topic.topic4 Topic.topicS Topic.topic6 Topic tonic7& 
annotations-htmI-sec-webbedoc-subsec2-l I opic.topic7& 



// The Topics and TopicVariations 
Topic topic4 
35 |variations=topic4a& 

annotations=html-topic^webbedoc-default| 

Topic Variation topic4a 
|condition=0& 

40 componentList-Sentence.sent4a-lSentence.sent4a«2& 
annotations=htmI-topic-webbedoc-default| 



Topic topics 

|variations=topic5a topicSb topicSc topic5d& 
annotations=html-topic-webbedoc-default| 

Topic Variation topic5a 

|condition=(and (role physician) (technical high))& 
coniponentList=Sentence.sent5a- 1 & 



22 



wo 99/08205 



PCT/CA98/00771 



annotations=html-topic-webbedoc-default| 

TopicVariation topic5c 
|condition=(and (not (role physician)) (technical high))& 
5 componentList=Sentence.sent5c- 1 & 

annotations=html-topic-webbedoc-default| 

Topic topic? 
|variations=topic7a topic7b& 
1 0 annotations=html-topic-webbedoc-default| 

TopicVariation topic7a 
|condition=(technical low)& 
componentList=Sentence.sent7a- 1 & 
15 annotations=html-topic-webbedoc-default( 

TopicVariation topic7b 
|condition=(technical high)& 
componentList=Sentence.sent7b- 1 & 
20 annotations=html-topic-webbedoc-default| 

Topic topic-compliance 
|variations=topic-compliance-a& 
annotations=html-topic-webbedoc-default| 

25 

TopicVariation topic-compliance-a 
|condition=()& 

componentList=Sentence.sent-compliance-l Sentence.sent-compliance-2 
Sentence.sent-compliance-3 Sentence.sent-compliance-4& 
30 annotations=html-topic-webbedoc-default| 

// The Sentences and SentenceVariations 
Sentence sent4a-l 
35 |variations=sent4a- 1 i&: 

annotations=html-sent-webbedoc-default| 

Sentence Variation sent4a-li 
|condition=()& 
40 coinponentList=0& 

levelList=SentenceRepLevel.sent4a-li-english& 
annotations=html-sent-webbedoc-default| 

SentenceRepLevel sent4a-l i-english 
45 |repLevel=english& 

componentList-'Why do we want to be able to produce tailored 

documents?"& 
annotations=html-sent-webbedoc -default] 

50 
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Sentence sent4a-2 
|variations=sent4a-2i& 
annotations=html-sent-webbedoc-default| 

5 Sentence Variation sent4a-2i 
|condition=()& 
componentList=()& 

leve]List=SentenceRepLevel.sent4a-2i.english& 
annotations=html-sent-webbedoc-defauIt| 

SentenceRepLevel sent4a-2i-english 
!repLevel=english& 
compo,»„a^isj-..Because research in con,mu„ica,io„ has shown 

annotations=htmI.sent-webbedoc-default| 



10 



20 



25 



30 



Sentence sent5a-l 
I variations=sent5a- 1 i& 

annotations=html-sent-webbedoc-default| 

SentenceVariation sent5a-li 
|condition=^()& 
componentList=()& 

leveIList=SentenceRepLevel.sent5a-li-english& 
annotations=htm]-sent-webbedoc-default| 

SentenceRepLevel sent5a-li-english 
|repLevel=engJish& 



35 



componentList-Studies have shown that health information that is tailored 

-lexComphance- and subsequent outcome "& '"'"'''^''"'^S 
annotations=html.sent-webbedoc-defauIt| 



Sentence sent7a-l 
|variations= sent7a-]i& 

annotations=html-sent-webbedoc.default| 

40 SentenceVariation sent7a- 1 i 
|condition=0& 
coniponentList=0& 

levelList=SentenceRepLevel.sent7a-li-engIish& 
annotations=html-sent-webbedoc-default| 



SentenceRepLevel sent7a- 1 i-english 
|repLevel=english& 
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componentList="But it can be very difficult to write and keep track 

of many versions of the same ^lexSynonymsl^,"& 
annotations=html-sent-webbedoc-default| 

5 Sentence sent8a-l 

|variations=sent8a-l i& 
annotations=html-sent-webbedoc-default| 

Sentence Variation sent8a-li 
10 |condition=()& 

componentList=()& 

levelList=SentenceRepLevel.sent8a- 1 i-english& 
annotations=html-sent-webbedoc-default| 

1 5 SentenceRepLevel sent8a- 1 i-english 
|repLevel=english& 

componentList="What is needed is a computer system for the production 
of tailored health-information and patient-education 
documents, that would, on demand, customize a 'master 
20 document' to the needs of a particular individual."& 

annotations=html-sent-webbedoc-defaxilt| 

Sentence sent8a-2 
25 |variations=sent8a-2i& 

annotations=html-sent-webbedoc-default| 

SentenceVariation sent8a-2i 
|condition=()& 
30 componentList=()& 

levelList=SentenceRepLevel.sent8a-2i-english& 
annotations=html-sent-webbedoc-default| 

SentenceRepLevel sent8a-2i-english 
35 |repLevel=english& 

componentList="The HealthDoc project has currently built the first 

^lexDiabetesMaster^ of such a system."& 
annotations=html-sent-webbedoc-default| 

40 Sentence sent-compliance-1 

|variations=sent-compliance-l a& 
annotations=htmI-sent-webbedoc-default| 



45 

SentenceVariation sent-compliance-1 a 
|condition=()& 
componentList=()& 

levelList=SentenceRepLevel.sent-compliance- 1 a-english& 
50 annotations=html-sent-webbedoc-default| 
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SentenceRepLevel sent-compliance-1 a-engJish 
|repLevel=english& 

'-"^^----^^"^---nt experiments have shown that health-education 
5 ^natenalcanbemuchmoreefifectiveifitis 

customized for the individual reader in accordance 
with then- medical conditions, demographic variables 

.nn t P^T"^ P™^'^' ""^^^ '■^'^^^t factors."& 
^ annotations=html-sent-webbedoc-default| 

Sentence sent-compliance-2 
|variations=sent-compliance-2a& 
annotations=html-sent-webbedoc-default| 

SentenceVariationsent-compIiance-2a 
|condition=()& 

componentList=()& 

levelList=SentenceRepLevel.sent-compiiance-2a-english& 
annotations=html-sem-webbedoc-default| ^°§"sn& 

SentenceRepLevel sent-compliance-2a-english 
|repLevel=english& 

componentList="For example, Dr Victor Strecher (now at the 
Coniprehensive Cancer Center of the University of 
Michigan) and colleagues sent unsolicited leaflets to 
patients of family practices on topics such as giving 
up smoking, improving dietary behaviour, or having a 
mammogram."& ^ 

annotations=html-sent-webbedoc-default| 

Sentence sent-compIiance-3 
|variations=sent-comp]iance-3a& 
annotations=html-sent-webbedoc-default| 

SentenceVariationsent-compliance-3a 
|condition=()& 

componentList=()& 

levelList=SentenceRepLevel.sent-compliance-3a-engiish& 
annotations=html-sent-webbedoc-default| 

SentenceRepLevel sent-compIiance-3a-english 
|repLevel=english& 

componentList='M leaflet was 'tailored' to the recipient, on the 
basis of data gathered from them in an earlier survey »& 
annotations=html-sent-webbedoc-default| "urvey. & 

Sentence sent-compliance-4 
|variations=sent-compliance-4a& 
annotations=html-sent-webbedoc-default| 
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Sentence Variation sent-compliance-4a 

|condition=0& 
componentList-()& 

levelList=SentenceRepLevel.sent-compliance-4a-english& 
5 annotations=html-sent-webbedoc-default| 

SentenceRepLevel sent-compliance-4a-english 
|repLevel=english& 

componentList="In each study, the 'tailored' leaflets were found to 
10 have a significantly greater effect on the patients* 

behaviour than 'generic' leaflets had upon patients 
in a control group."(& 
annotations=html-sent-webbedoc-default| 

15 

// The Lexicals and LexicalVariations 
Lexical lexSynonymsl 
|variations=lexSynonymsl a lexSynonymsl b& 
20 annotations^! 

Lexical Variation lexSynonymsl a 
|condition=(role physician)& 
string="brochure"& 
25 value=Word.brochure& 
annotations=| 

LexicalVariation lexSynonymslb 
|condition=(not (role physician))& 
30 string- 'information"& 

value=Word.information& 
annotations=I 

Lexical lexCompliance 
35 |variations=lexCompliance-a& 
annotations=| 

LexicalVariation lexCompliance-a 
|condition=(role physician)& 
40 string="tailored health-information"& 
value=Topic.topic-compliance& 
annotations=| 

Lexical lexDiabetesMaster 
45 |variations=lexDiabetesMaster-a& 
annotations=| 



50 
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LexicalVariationlexDiabetesMaster-a 
|condition=()& 

string=''prototype"& 

value=External.external-diabetes& 
5 annotations=| 

//The Words 
Word brochure 
|value="brochure"| 

10 

Word information 
|value="information"| 

// The Annotations 
1 5 Annotation html-doc-webbedoc-tople vel 
title="The HeahhDoc Home Page"j 

Annotation html-doc-webbedoc-doc-a 
|background="blue2.gif'& 
20 bgcolor="#ffffef'& 
vlink="#990099"& 
alink="#990099"& 
link="#990099"& 

title-begin="<center><font size = h-4 color = \"9900QQ\»>"^ 
25 title-end="</font></center>"& 

image-dir-="/'^healthdo/images/"& 
image-align="alt"& 

parent=htmI-doc-webbedoc-topIevel| 

30 Annotation html-sec-webbedoc-secl 

|title-begin="<font size = +1 color = \"990099\">"^ 
title-end="</font>"& 

title-"The goal of the HealthDoc project"& 
parent=htmI-doc-webbedoc-top]evel| 

Annotation html-sec-webbedoc-secl a 
|image="businmenjpg"& 
parent=html-sec-webbedoc-sec 1 1 

40 Annotation htnil-sec-webbedoc-sec2 

|title-begin="<font size = +1 color = \"990099\">"^ 
title-end="</font>"& 
title="The motivation for the research'** 
parent=html-doc-webbedoc-topIevelj 
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50 



// The External objects 
External external-diabetes 
|fiIeName="diabetes.master"& 

profile=<list of parameters describing current user/audience>( 
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Example 2: Customizable Health Information 

// The parameters 
5 PurposeParameters 

I type=insulin-dependent non-insulin-dependent& 
technical=high-technical moderate-technical low-technical& 
age=senior adult young-adult child& 
locus-of-control=doctor patient] 

10 

RepresentationLevelParameters 
jengiish spl| 

// The top-level object 
1 5 topleveHDocument.diabetes 

// The Documents and DocumentVariations 
Document diabetes 
|title="Treating Your Diabetes"& 
20 variations=doc-a& 

annotations=html-doc-diabetes-toplevel discourse-doc-diabetes-toplevel| 

DocumentVariation doc-a 
|condition=0& 

25 componentList=Section.secl Section.sec2 Section.sec3 Section.sec4& 
annotations==html-doc-diabetes-doc-a discourse-doc-diabetes-toplevel| 

// The Sections and SectionVariations 
Section seel 
30 I variations=sec I a& 

annotations=html-sec-diabetes-secl discourse-sec-diabetes-sec 1 1 

SectionVariation sec la 
|condition=()& 

35 componentList=Section.subsec 1 - 1 Section.subsec 1 -2& 

annotations=html-sec-diabetes-sec 1 a discourse-sec -diabetes-sec 1 1 

Section subsecl-1 
I variations=subsec 1 - 1 a& 
40 annotations=html-sec-diabetes-subsec 1 - 1 discourse-sec-diabetes-sec 1 1 

SectionVariation subsecl-1 a 
|condition=()& 

componentList=Topic.topicl & 
45 annotations=html-sec-diabetes-subsec 1 - 1 a discourse-sec-diabetes-sec 1 1 

Section subsecl-2 
|variations=subsecl -2a& 

annotations=html-sec-diabetes-subsecl -2 discourse-sec-diabetes-sec 1 1 

50 
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SectionVariation subsecl-2a 
|condition=()& 

componentList=Topic.topic2 Topic.topic3 Topic.topic4 

Topic.topicS Topic.topic6& 
annotations=html-sec.diabetes-subsec 1 -2a discourse-sec-diabetes-sec 1 1 

// The Topics and TopicVariations 
Topic topicl 
|variations=topic la<& 

annotations^html-topic-diabetes-defaultdiscourse-topic-diabetes-topicl^ 

Topic Variation topic la 
|condition=()& 

componentList-Sentence.sent 1 a- 1 Sentence.sent 1 a-2& 
annotations=html-topic-diabetes-default discourse-topic-diabetes-topic 1 1 

Topic topic3 
|variations=topic3a topic3b& 

arniotatjons^html-topic-diabetes-defaultdiscourse-topic-diabetes-topi 

TopicVariation topic3a 
|condition=(type insulin-dependent)& 
componentList=Sentence.sent3a- 1 & 

annotations=html-topic-diabetes-defaultdiscourse-topic.diabetes-topic3t 

TopicVariation topic3b 
|condition=(type non-insulin-dependent)& 
componentList=Sentence.sent3b-l& 

annotations=html-topic.diabetes-defaultdiscourse-topic-diabetes-topic3 

// The Sentences and Sentence Variations 
Sentence sent la- 1 
I variations=sent 1 a- 1 i& 

annotations=html-sent-diabetes.defauhdiscourse-sent-diabetes-default| 

Sentence Variation sent 1 a- 1 i 
|condition=()& 
componentList=Q& 

leveIList=SentenceRepLevel.sentla-li-englishSentenceRepLevel.sentla-li-spl& 
annotations=html-sent-webbedoc-defauIt| 



SentenceRepLevel sentl a- 1 i-english 
|repLevel=english«& 



componentList-LexicaLlexDiab Lexical.lexis Lexical.lexa Lexical.lexgroup 
Lexical.lexof Lexical.Iexconds Lexical.lexin Lexical.lexwhich 
Lexical.lexglucose Lexical.lexlevels Lexical .lexare 
Lexical.lexabnormally Lexical.lexhigh.& 

annotations=html-sent-diabetes-defaultdiscourse-sent-diabetes-default| 
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SentenceRepLevel sentla-li-spl 
|repLevel=spl& 

componentList="<a Sentence Plan Language (SPL) form>"& 
annotations=html-sent-diabetes-default discoiirse-sent-diabetes-default| 

5 

Sentence sent3a-l 
|variations=sent3a-li& 

annotations=html-sent-diabetes-default discourse-sent-diabetes-default| 

1 0 Sentence Variati on sent 3 a- 1 i 
|condition==()& 
componentList=()& 

levelList=SentenceRepLeveLsent3a- 1 i-english SentenceRepLevel.sentSa- 1 i-spl& 
annotations=html-sent-webbedoc-default| 

15 

SentenceRepLevel sent3 a- 1 i-engiish 
|repLevel=english& 

componentList="The condition that you have is insulin-dependent diabetes."& 
annotations=htni]-sent-diabetes-default discourse-sent-diabetes-default| 

20 

SentenceRepLevel sent3a-li-spl 
|repLevel=spl& 

componentList="(asc / ascription 
:tense present 
25 :domain (condl / abstraction 

:lex condition 
:determiner the 
:process (have / ownership 
:lex have-possession 
30 :tense present 

:doniain (hearer / person) 
:range cond)) 
irange (diab2 / abstraction 
:lex diabetes 
35 :determiner zero 

iproperty-ascription (ins / quality 

:lex insulin-dependent)))"& 
annotations=html-sent-diabetes-default discourse-sent-diabetes-default| 
// The Lexicals and LexicalVariations 
40 Lexical lexDiab 

|variations=lexDiab-a& 
annotations=| 

LexicalVariation lexDiab-a 
45 |condition=()& 

string="Diabetes"& 
value=Word.Diab& 
annotations=| 

50 
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Lexical lexglucose 
|variations=lexglucose-a& 
annotations=| 

5 LexicalVariation lexglucose-a 
|condition=()| 
string="glucose"& 
value=Word.glucose& 
annotations=| 

10 

Lexical lexhigh 
|variations=lexhigh-a& 
amiotations=^( 

1 5 LexicalVariation lexhigh-a 
|condition=()| 
string="high"& 
value=Word.high& 
annotations=| 

20 

// The Words 
Word Diab 
tvalue=-"Diabetes"&| 

25 Word glucose 

|value="glucose"| 

Word high 
|value=="high"&| 

30 



// The Annotations 

35 // // HTML Annotations 

Annotation html-doc-diabetes-toplevel 
|title="About Your Diabetes"| 

Annotation html-doc-diabetes-doc-a 
40 |bgcolor="#ffffef'& 

title-begin-"<hl align=\"center\">"&title-end="</h]>»& 
parent=html-doc-diabetes-toplevel| 

Annotation html-sec-diabetes-default 
45 // <defauh HTML markup for any Section in diabetes document>| 

Annotation html-sec-diabetes-secl 
|title="Basic information"& 
parent-html-sec-diabetes-defaultl 

50 
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Annotation html-sec-diabetes-secla 
|title-begin="<h2 align=V'centerW*&title-end="</h2>"& 
parent=html-sec-diabetes-secl I 

5 Annotation html-sec-diabetes-subsec 1 - 1 
|title="What is diabetes?"& 
parent=html-sec-diabetes-secl I 

Annotation html-sec-diabetes-subsec 1 - 1 a 
1 0 |section-end- '<p>"& 

title-begin-"<h3>"&title-end="</h3>"& 
parent=html-sec-diabetes-subsec 1 -1 1 

Annotation html-sec-diabetes-subsec 1 -2 
1 5 |title="The two types of diabetes"& 
parent=html-sec-diabetes-secl I 

Annotation html-sec-diabetes-subsecl -2a 
|section-end=''<p>"& 
20 title-begin="<h3>"&title-end="</h3>'*& 
parent=html-sec-diabetes-subsec 1 -2] 

// // Linguistic Annotations 
Annotation discourse-doc-diabetes-toplevel 
25 |title=" About Your Diabetes"! 

Annotation discourse-sec-diabetes-sec 1 
|title="Basic information"& 
relations="((ord < (topic2a topic3a)) 
30 (ord < (topic2a topic3b)) 



35 



(ord < (topic2a topic4a)) 
(ord < (topic2a topic5a)) 
(ord < (topic2a topicSb)) 
(ord < (topic2a topicSc)) 
(ord < (topic2a topicSd)) 
(ord < (topic2a topic6a)) 
(ord < (topic2a topic6b)) 
(ord < (topic3a topic6a)) 
(ord < (topic3b topic6b)) 
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(elaboration topic4a topic3b) 
(justification topic2a topic3a) 
(justification topic2a topic3b) 
(justification topic2a topic4a) 
(elaboration topic4a topic2a) 
(elaboration topicSa topic3a) 
(elaboration topicSb topic3b) 
(elaboration topicSc topic3a) 
(elaboration topicSd topic3b) 
(justification topic3a topic6a) 
(justification topic3b topic6b)' 
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Annotation discourse-sec-diabetes-subsec 1 - 1 
|tit]e="What is diabetes?"& 

parent=discourse-sec-diabetes-sec 1 1 

5 

Annotation discourse-sec-diabetes-subsec I -2 
|title='The two types of diabetes"& 
parent=discourse-sec-diabetes-sec 1 1 

1 0 Annotation discourse-topic-diabetes-topic3 

|corefs="((condl specific cond) 

(diab2 specific diab) 

(condl generic diab2))"& 

parent=discourse-sec-diabetes-sec 1 1 
15 ' 
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The Pseudocode 

The program objects are: 

BasicObject. 
5 ResolvableObject. 

DocumentObject. 

DocumentObjectSet. 

VariationContainer. 

Variation. 
10 Condition. 

WorkingCondition. 

Annotation. 

External. 

15 

The Procedures 

Procedures used by BasicObject classes 

These procedures are used within BasicObject classes (e.g., BasicDocument, 
20 BasicSection, etc.) 

Procedure: SetProperties 

Parameter: 

A list of property names and their corresponding values 

25 

Algorithm: 
for each property in the list do 
set its value 

30 Procedures used by VariationContainer classes 

These procedures are used within VariationContainer classes (e.g., Document, 
Section, Topic), which have a list of variations. VariationContainer classes are 
extensions of ResolvableObject and therefore have a Resolve method. 
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Procedure: SetProperties 

Parameter: 

A list of property names and their corresponding values 
Algorithm: 

for each property in the list do 
if property is a list of variations then 

set the class property "variations" to given value 
else if property is a list of annotations then 

set the class property "annotations" to given value 
else if property is defined for this class then 

set its value 
else signal an error 
end if 
end for 



Procedure: Resolve (for VariationContainer classes) 
Parameters 

- (input) 

An instance of WorkingCondition 

(a list of purpose parameters and their current values) 

- (input) 

An instance of List 

(a list of the desired representation levels to output) 

- (output) 

An instance of DocumentObjectSet, 
i.e., a set of references to resolved DocumentObjects, 
with one set member for each desired level of representation 
of this VariationContainer instance 
Algorithm: 

if Resolve has already been called with this WorkingCondition then 

result is the previously saved result 
else 

call Satisfies on each variation of this Variation Container until 
the WorkingCondition is satisfied 
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call Resolve on this satisfying variation to 

return a DocumentObjectSet 
add the appropriate annotations for this VariationContainer into 
the returned DocumentObjectSet 
5 end if 

if no variation satisfies the WorkingCondition then 
result is null 

else 

result is the annotated DocumentObjectSet for this VariationContainer 
10 end if 



Procedures used by Variation classes 

These procedures are used within Variation classes (e.g., DocumentVariation, 
SectionVariation), which therefore have a selection condition. 
15 Procedure: SetProperties 

Parameters: A list of property names and their corresponding values 
Algorithm: 

for each property in the list do 
if property is a condition then 
20 set the class property "condition" to given value 

else if property is a list of annotations then 

set the class property "annotations" to given value 
else if property is a list of components then 
set the class property "componentList" to given value 

25 

else if property is defined for this class then 

set its value 
else signal an error 
end if 

30 end for 
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Procedure: Satisfies 

Parameters: 

- (input) 

An instance of WorkingCondition 

- (output) 

A Boolean value 
Algorithm: 

if this variation satisfies the WorkingCondition then 

result is true 
else 

result is false 
end if 



Procedure: Resolve (for Variation classes) 
Parameters: 

- (input) 

An instance of WorkingCondition 

- (input) 

An instance of List 

(a list of the desired representation levels to output) 

- (output) 

An instance of DocumentObjectSet, 
i.e., a set of references to resolved DocumentObjects, 
with one set member for each desired level of representation 
of this Variation instance 
Algorithm: 

create a new DocumentObjectSet for this Variation 
for each component of this Variation do 
call Resolve on the current component to 

return a DocumentObjectSet for this component 
add the appropriate annotations for this Variation into 

the returned DocumentObjectSet 
attach the annotated DocumentObjectSet 

as a child of the DocumentObjectSet for this Variation 
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end for 

result is the annotated DocumentObjectSet for this Variation 

Toplevel Procedures 

5 These are the toplevel procedures used to read in a datafile containing 

a master document, create instances of the document-class objects, then loop to read 
in new values of the purpose parameters and generate an appropriately customized 
version of the document, with all appropriate annotations, at each level of 
representation as specified by the representation-level parameters given in the 

10 datafile. 

Procedure: Parse 

Parameter: 
Name of datafile to be read in 

15 

Algorithm: 
while end-of-file has not been reached 
read in the next line of the datafile 

if the line is a comment or a blank line then 
skip over it 

else if the line specifies the toplevel DocumentObject then 

set the "toplevel" variable to reference this object 
else if the line specifies the purpose parameters and their values then 

set the "purposeParameters" variable 
else if the line specifies the possible representation levels then 

set the "repLevels" variable 
else instantiate the specified document object 
(i.e., create a new executable instance of this document-object class, 
set a reference to this instance, 
assign a name to this instance, 
assign its properties) 
end of while loop 
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return the reference to the toplevel DocumentObject, 

the list of purpose parameters and their possible values, 
the list of desired representation levels 

5 Procedure: Reader 

Algorithm: 
call an application-specific interface to: 

- read in current values of purpose parameters 

- read in desired representation levels 

- create an instance of WorkingCondition using these values 



Procedure: Main 

Parameter: 
Name of the input datafile 
^5 Algorithm: 
call Parse 
call Reader 

while n&w purpose parameters are input 
call Resolve on the toplevel object 
for each specified level of representation 

output the corresponding DocumentObjectSet 
end for 
call Reader 
end of v^hile loop 
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30 



The present application has been described with reference to a presently preferred 
embodiment. Modifications and variations of that embodiment will be apparent to a 
person of skill in the art. Such modifications and variants are believed to be within 
the scope of the present invention as defined in the claims appended hereto. 
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THE EMBODIMENTS OF THE INVENTION IN WHICH AN EXCLUSIVE 
PROPERTY OR PRIVILEGE IS CLAIMED ARE DEFINED AS FOLLOWS: 

1 . A computer system for generating custom versions of a master document in 
accordance with user purpose parameters, said system comprising: 

5 (a) a datafile including a data structure specifying said master document; 

(b) a document class library for providing general document class definitions; 

(c) a parser for creating executable instances of said document-class data 
structures from said datafile; 

(d) a user input interface for inputting said purpose parameters; and 

10 (e) a selection engine for generating said custom versions of said document from 
said instances of said document class library by utilizing current values of said 
purpose parameters. 

2. A computer system as defined in claim 1 , said document including a plurality of 
15 elements and said data structure defining relationships between said elements and 

variations thereof 

3. A computer system as defined in claim 1 , said instances including a plurality of 
elements and variations each arranged in a hierarchy of predetermined 

20 relationships. 

4. A computer system as defined in claim 3, each element including a resolver for 
selecting from its variations and each variation including a resolver for expanding 
said variation into its component document objects. 

25 

5. A computer system as defined in claim 3, said elements being the components of 
said document structure. 

6. A computer system as defined in claim 1, said instances each including linguistic 
30 information for providing automated grammatical and stylistic correction of said 

customized documents. 

7. A computer readable memory device encoded with a data structure for generating 
custom versions of a master document, the data structure having a plurality of 
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general class objects for describing elements and variations providing, structure 
and content of said master document. 



8. A device as defined in claim 6, said data structure including: 

(a) a first data block for identifying user purpose parameters for selecting versions 
of said master document; 

(b) a toplevel object for identifying a document-class instance; and 

(c) a program structure for specifying the form and content of said custom 
versions of said master document. 



10 
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30 



9. 



A device as defined in claim 7, said data structure including an external object for 
describing instances of an external class for defining links to other master 
documents to thereby to create a network of systems for generating custom 
documents. 



10. A device as defmed in claim 8, said links being hypertext links. 

1 1. A method for generating custom versions of a master document implemented in a 
computer system and in accordance with user purpose parameters, said method 

20 comprising the steps of: 

(a) specifying said master document having a datafile and including a data 
structure; 

(b) providing a document class library having general document class definitions; 

(c) parsing said datafile for creating executable instances of said document-class 
25 data structures; 

(d) a user input interface for inputting said purpose parameters; and using current 
values of said purpose parameters to generate custom versions of said 
document fi-om said instances of said document class library. 



12. A method as defined in claim 1 1, including executing said instance for selecting 
fi-om variations of an element and expanding each variation into its component 
document objects, wherein each said instances includes a plurality of elements and 
variations each arranged in a hierarchy of predetermined relationships. 
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Block 1 — The parameters: 

PurposeParameters 

(<feature l>=<list of possible values>)& 
(<feature 2=<list of possible values>)& 
[Subsequent lines define remaining features] 

Repres ent at ionLevelPararaet er s 

(<list of representation levels to output>) 

Block 2 — Identification of the top-level object: 

toplevel=Docunient , <name of main Docmnent> 
Block 3 — Definitions of all Documents and their vaiiations: 
Sub-block: Definition of a Document and its variations. 
Field: Definition of the Document. 

Document <naine of docuinent> 

lvariations=<list of variations of the docuinent>& 
annotations=<list of annotations>) 
Field: Definitions of the Document's variations. 

Subfield: Definition of a variation of the Document. 

DocumentVariation <naine of document variation> 
I condition=<Boolean expression>& 

componentList=<list of components of the document variation>& 
annotations=<list of annotations>| 
Subsequent subfields define remaining variations of the Document. 

Subsequent sub-blocks define remaining Documents and their variations. 
Block 4 — Definitions of all Sections and their variations: 

Sub-block: Definition of a Section and its variations. 
Field: Definition of the Section. 

Section <name of section> 

|variations=<list of variations of the section>& 
annotations=<list of aimotations>| 
Field: Definitions of the Section's variations. 

Subfield: Definition of a variation of the Section. 

Sect ionVciriat ion <name of section variation> 
lcondition=<Boolean expressioii>& 

componentList=<liSL of components of the section vaLriation>& 
axmotations=<list of annotations>| 
Subsequent subfields define remaining variations of the Section. 

Subsequent sub-blocks define remaining Sections and iheir variations. 
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Block 5 — Definitions of all Topics and their variations: 
Sub-block; Definition of a Topic and its variations. 
Field: Definition of the Topic. 

Topic <naine of topic> 

I variations=<list of variations of the topic>t 
aimotations=<list of annotat ions> I 
Field: Definitions of the Topic's variaiions. 

Subfield: Definition of a variation of the Topic. 

TopicVariation <naine of topic variatioii> 
|conditioii=<Boolean expressioii>& 

componentList=<list of components of the xopic variation>& 
annotations=<list of aiinotations>l 
Subsequent subfields define remaining variations of the Topic. 

Subsequent sub- blocks define remaining Topics and their variations. 
Block C — Definitions of all Sentences and their variations: 
Sub-block: Definition of a Sentence and its variations. 
Field: Definition of the Sentence. 

Sentence <naine of sentence> 
|variations=<list of variations of Eentence>& 
annotations=<list of annotations> I 
Field: Definitions of the Sentence's variations. 

Subfield: Definition of a variation of the Sentence. 

Sent enceVariat ion <naitte of sentence variacion> 
!condition=<Boolean expressioii>& 
componentList=<list of component s>& . 
levelList=<list of representation levels>& 
annotat ions=<list of annotations>i 
Subfield: Definitions of the Sentence's representations. 
SentenceRepLevel <riaine> 

|repLevel=<list of representation levels>& 
componentList=<a string or list of component s>& 
annotations=<list of annotations> I 
Subsequent subfields define remaining variations of the SenteriC'r and their r<>i)rosentations. 

Subsequent sub-blocks define remaining Sentences and their variations. 
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Block 7 — Definitions of all Lexicals and their variations: 
Sub-block: Definition of a Lexical and its variations. 
Field: Definition of the Lexical. 

Lexical <naine of lexical iteiD> 

lvariatioiis=<list of variations of lexical itein>& 
aiinotations=<list of aimotations> I 
Field: Definitions of the Lexicars variations, 

Subfield: Definition of a variation of the Lexical. 

Lexical Variation <naine of lexical variation> 
icon<iition=<Boolean express ion>& 
string=<character string>& 
value=<Docum€ntClass> . <ob jectNaine>& 
annotations=<list of annotations>| 
Subsequent subfields define remaining variations of the LexicaL 

Subsequent sub-blocks define remaining Lexicals and their variations. 
Block 8 — Definitions of all Words: 
Field: Definition of a Word. 

Word <word> 
|value="<word>"| 

Subsequent fields define remaining Words. 
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Annotation <naine of the Annotation object> 
I <property>="<value>'*& 
<property>="<value> '*& 

<Subsequent lines define remaining properties and their values>& 
parent=<name of the immediate ancestor of this Annotation object>| 



f\Cofi£ 3C<^:> 



5/8 



SUBSTITUTE SHEET (RULE 26) 



wo 99/08205 PCT/CA98/00771 



External <name of the External object> 
If ileName="<f ile naiiie>"& 

prof ile=<list of parameters describing current user/aiidience> | 
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